home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / ansi / smile25.zip / SMILE25.DOC < prev   
Text File  |  1992-06-12  |  20KB  |  482 lines
  1.  
  2. SMILE   Ver 2.5 ..Copyright (c) 1990,1992.. by: Michael Arnett
  3.  
  4.  
  5. SMILE Viewer is an ANSI display/library utility that allows the user
  6. to view files containing ANSI sequences, Music strings in BASIC
  7. "PLAY" format and Sounds using a custom SOUND code.
  8.  
  9. SMILE builds and maintains a list of user selectable screens in a
  10. file for each Directory selected.  This allows the user to add Artist
  11. names and/or comments to each File Name using SMILE's built-in Edit
  12. feature.  A text editor may also be used to edit the list file.  Line
  13. length for File Name and Comments should be sixty characters or less.
  14. The "│" (Dec 179) delimiter should not be moved or altered when editing.
  15. When entering new lines, use ASCII character 179 to enter the delimiting
  16. character.
  17.  
  18. NO ANSI DRIVER is required to view ANSI screens as SMILE contains a
  19. built-in ANSI translator.  Keyboard reassignment codes are ignored.
  20. ESC translate codes #96, #249 and #250 are supported.
  21.  
  22.  
  23. GETTING STARTED:
  24.  
  25. SMILE Requires approximately 350K of memory to run.  This allows for
  26. a large list of names to be displayed.  Testing was done with a list
  27. of 1000+ file names and full descriptions.  Options such as TAG, SORT and
  28. SAVE take noticably longer with very large lists.  
  29.  
  30.  
  31. Place SMILE.EXE in the current directory, or in a directory in your
  32. PATH, and enter SMILE at the DOS prompt. 
  33.  
  34. While loading, SMILE checks for the list file FILELST.DAT by default,
  35. or the file specified by the /L command line switch.  If not found, a
  36. list of files, in the current directory, ending in .ANS is built in
  37. memory and displayed for viewing.
  38.  
  39. In earlier versions of SMILE, any changes to the current list were 
  40. automatically saved to disk.  You must now select the SAVE option 
  41. from the MISC menu while using the SMILE Viewer.  If changes are made
  42. you will be prompted to SAVE the list when you EXIT, change drives or
  43. directories, or load a new list.  If you do a lot of list editing, 
  44. please SAVE periodically to avoid loosing data to blinking lights etc.
  45.  
  46.  
  47. Line length and file size is limited only by the amount of available 
  48. memory.  Multiple line of MUSIC may be entered between ESC[ and CTRL-N.
  49.  
  50.  
  51.  
  52. COMMAND LINE SWITCHES  [optional]
  53.  
  54.  
  55. /LFile   - "File" is the name of the list file you want loaded.
  56.  
  57.            Example:  SMILE /Lmylist.dat
  58.  
  59. /A:DRV:\PATH\FILE.NAM  - complete path of your ANSI editor.
  60.  
  61.            Example:  SMILE /A:C:\ANSI\THEDRAW.EXE
  62.  
  63. /E:DRV:\PATH\FILE.NAM  - complete path of your TEXT editor.  
  64.  
  65.            Example:  SMILE /E:C:\UTIL\QEDIT.EXE
  66.  
  67. /S       - disable "DOS SHELL" option.
  68. /U       - disable "UPDATE\REBUILD" options.
  69. /D       - disable "DELETE TAGGED" option.
  70. /R       - disable "DRV\DIR" change option.
  71. /I       - disable "EDIT INFO" option.
  72. /X       - disable "ANSI\TEXT" Editor options.
  73.  
  74. /K       - KID PROOF  (invokes ALL of the above DISABLE options)
  75.  
  76. All or any combination of these switches may be used on the Command
  77. Line with a SPACE between each one.  They need not be in any
  78. particular order.
  79.  
  80.  
  81.  
  82. VIEWING FILES:
  83.  
  84. The main screen consists of several KEY COMMANDS and a display of the
  85. first twelve files in FILELST.DAT.  You may scroll through all the
  86. files using any of the cursor direction keys.  The bottom line of the 
  87. scroll window contains the File Name of the current List File, total
  88. number of file names listed and number of tagged file names.
  89.  
  90. Press ENTER to display the Highlighted file in ANSI mode.
  91. Press CTRL-ENTER to display the Highlighted file in TEXT mode.
  92.  
  93.   MOUSE SUPPORT:
  94.  
  95.   A RED smile face will display as the mouse cursor in the upper left
  96.   corner of the selection box.  
  97.  
  98.   Click the Left button once to MOVE the highlight bar.  Double click
  99.   the Left button to view the highlighted file in ANSI mode.  Click
  100.   the LEFT and RIGHT mouse buttons together to view the highlighted 
  101.   file in TEXT mode.  
  102.  
  103.   In most cases, the left button will act as the ENTER key, and the 
  104.   Right button acts as the ESC key.  USE the slide bar to scroll the 
  105.   list.
  106.  
  107.   *** Some early revisions of Logitech Mouse Drivers do not fully display
  108.   *** the mouse cursor in EGA\VGA (43\50 Line) mode. 
  109.  
  110.  
  111. SMILE will pause 
  112.  
  113. At the end of each screen display
  114. If the SPACE BAR is pressed "during" display 
  115. If CTRL-E is the first character of a line in the file.
  116.  
  117. Press any key to continue the display or ESC to cancel.
  118.  
  119.  
  120. KEY COMMANDS:
  121.  
  122.  
  123.  
  124. LETTER or NUMBER Key:  Begins search on the sorted field for a match
  125.      of the characters you enter.  Accuracy of the search increases
  126.      with more characters.  For example, entering "a" will find the
  127.      first line of text that contains an "a" anywhere in the text.
  128.      The search is NOT case sensitive.  The highlight bar moves to
  129.      the first "matched" record.  If your list is very large the 
  130.      search could take a few seconds.
  131.  
  132. INS, SPACE BAR or RIGHT MOUSE BUTTON 
  133.      TAG or UNTAG the Highlighted file.  You may select several or all
  134.      of the File Names listed.  Files remain TAGGED even if they
  135.      scroll out of the selection window.  Files are TAGGED with the
  136.      current Display Speed and Display Mode.  By Toggling Display Mode
  137.      and changing the Display Speed, it is possible to TAG files with
  138.      different viewing characteristics.
  139.  
  140. F1   Displays brief HELP screen for each COMMAND KEY.  The
  141.      SMILE20.DOC file will be displayed if there is sufficient memory
  142.      and it is in the directory with SMILE.EXE.
  143.  
  144.      To ZOOM, MOVE, RESIZE or END this window, use the appropriate
  145.      mouse triggers or F5 to Zoom, CTRL-F5 to Move, ALT-F5 to Resize,
  146.      or ESC to End.
  147.  
  148. F2   TAG or UNTAG every file that matches your selection, (ALL, VIEWED
  149.      NON-VIEWED or USER DEFINED) including those not visible in the
  150.      selection window.  The DEFINE option prompts for a search
  151.      string.  This would allow tagging by Artist.  The entire File
  152.      Name and Comment field is searched for the specified text.
  153.      Files are TAGGED with the current Display Speed and Display
  154.      Mode.
  155.  
  156.  
  157. F3   Displays each TAGGED file consecutively. You can select to be
  158.      prompted for a key press after each file is displayed, or view
  159.      NON-STOP.  If you select NON-STOP you can adjust the number
  160.      seconds delay (1-99) between each screen or pause.
  161.  
  162. F4   Toggle Music ON or OFF.  This determines whether or not you
  163.      hear music if it is contained in the displayed file.
  164.  
  165. F5   Turns Edit Mode on and allows editing the artist name and comment
  166.      information.
  167.  
  168. F6   Toggle between 25 line and 43/50 line (EGA/VGA) mode if available.
  169.  
  170.  
  171. F7   Select Display speed.  Selections simulate modem baud rates.
  172.      Select 0 (default) for the fastest display.  Speed selections
  173.      include:
  174.    
  175.         19,200, 9600, 2400, 1200, 300
  176.  
  177.  
  178. F8 - LIST OPTIONS
  179.  
  180.      SAVE  The current List is saved to the specified File Name.
  181.            Press ESC to cancel save.
  182.  
  183.      LOAD  The List file name specified is loaded into memory.
  184.  
  185.      UPDATE  Updates the current List with new files that match the
  186.            current File Mask.  Existing artist\comment information
  187.            is retained.  File names that have been erased from the
  188.            directory are deleted from the list. If you see the
  189.            message: "FILE NOT FOUND" when viewing, select this option
  190.            to refresh the file name list.  You may also use a text
  191.            editor to delete file names from FILELST.DAT that are not
  192.            needed or no longer exist.
  193.  
  194.            NOTE: a tempory file is written to disk during this process.   
  195.  
  196.      REBUILD  Removes the current List from memory, then rebuilds
  197.            using the currently selected File Mask.  You will be
  198.            prompted to save the current list if any changes have been
  199.            made.
  200.  
  201.      SORT  You are prompted to sort alphabetically on File Name or
  202.            comment field.  Press ESC to cancel.
  203.  
  204.      DELETE TAGGED  You may select to delete tagged file names from
  205.            the LIST, from your Disk Drive or BOTH.
  206.          
  207.  
  208. F9 - Change FILE MASK, DRIVE or DIRECTORY. You may enter any DOS
  209.      com